.\" Copyright (c) 1999-2009 Massachusetts Institute of Technology
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining
.\" a copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\" 
.\" The above copyright notice and this permission notice shall be
.\" included in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
.\" CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
.\" TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
.\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\"
.TH H4FROMH5 1 "September 2, 2005" "h5utils" "h5utils"
.SH NAME
h4fromh5 \- convert HDF5 scientific dataset to an HDF4 file
.SH SYNOPSIS
.B h4fromh5
[\fIOPTION\fR]... [\fIHDF4FILE\fR]...
.SH DESCRIPTION
.PP
." Add any additional description here
h4fromh5 takes one or more files in HDF5 format and outputs files in
HDF4 format containing the datasets from the HDF5 files.  (Currently,
only a single dataset per HDF5 file is converted.)

HDF4 and HDF5 are free, portable binary formats and supporting libraries
developed by the National Center for Supercomputing Applications at
the University of Illinois in Urbana-Champaign.

 A single
.I h5
file can contain multiple data sets; by default,
.I h4fromh5
converts the first dataset, but this can be changed via the
.B -d
option, or by using the syntax \fIHDF5FILE:DATASET\fR.

The most basic usage is something like \'h4fromh5 foo.h5\', which
will output a file foo.hdf containing the scientific dataset from
foo.h5.
.SH OPTIONS
.TP
.B -h
Display help on the command-line options and usage.
.TP
.B -V
Print the version number and copyright info for h4fromh5.
.TP
.B -v
Verbose output.
.TP
.B -T
Transpose the output dataset (e.g. LxMxN becomes NxMxL).  This is often
useful because HDF5 programs typically follow C (row-major) conventions
while HDF4 programs often follow Fortran (column-major, transposed)
conventions for array ordering.
.TP
\fB\-o\fR \fIfile\fR
Send HDF output to
.I file
rather than to the input filename with .h5 replaced with .hdf (the
default).
.TP
\fB\-d\fR \fIname\fR
Read from dataset
.I name
in the input; otherwise, the first dataset in the input file is used.
Alternatively, use the syntax \fIHDF5FILE:DATASET\fR when the
input file names are specified.
.SH BUGS
Send bug reports to S. G. Johnson, stevenj@alum.mit.edu.
.SH AUTHORS
Written by Steven G. Johnson.  Copyright (c) 2005 by the Massachusetts
Institute of Technology.
